Endpoint Configurations
Route
/v2/endpoint-management/configurations
Description
List existing configuration modules or create new ones for performance, detection, content inspection, software, or policy overrides.
Methods
- GET — list all configurations
- POST — create a configuration module
Inputs (POST)
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Unique configuration name |
description | string | No | Optional description |
type | ConfigurationType | Yes | Configuration category (performance, detection, content_inspection, software, policy) |
config | object | Yes | JSON payload with override values |
Request Example (POST)
{
"name": "High Security Sensor Config",
"description": "Stricter inspection thresholds",
"type": "performance",
"config": {
"perf.cpu_limit": 80,
"perf.scaling_factor": 4
}
}
Output (GET/POST)
| Field | Type | Description |
|---|---|---|
type | string | Always "configurations" |
size | integer | Number of configurations returned |
resources | array[Configuration] | Configuration objects |
errors | array[Error] | Any errors |
Configuration Object (key fields)
| Field | Type | Description |
|---|---|---|
id | string | Configuration identifier |
name | string | Configuration name |
description | string | Description |
is_default | boolean | Whether this is the default |
type | string | Configuration type |
version | integer | Version number |
used_in_profiles | array[ProfileDetails] | Profiles that consume this configuration |
config | object | JSON payload with overrides |
Rate Limit
- 60 requests per minute per API key
- 5 concurrent requests per endpoint
Example Response (GET)
{
"type": "configurations",
"size": 1,
"resources": [
{
"id": "config-123e4567-e89b-12d3-a456-426614174000",
"name": "High Security Sensor Config",
"description": "Stricter inspection thresholds",
"is_default": false,
"type": "performance",
"version": 1,
"used_in_profiles": [
{
"profile_id": "profile-secure-laptops",
"profile_name": "Secure Laptops"
}
],
"config": {
"perf.cpu_limit": 80
}
}
],
"errors": []
}